home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / lan_nov / st95e321.zip / STOMPERE.DOC < prev    next >
Text File  |  1996-02-20  |  44KB  |  1,281 lines
  1.  
  2.  
  3.                                  Stomper  3.21
  4.                        
  5.                        
  6.                        
  7.                        
  8.  
  9.                        
  10.                   Modemsharing-Software for Novell or Netbios
  11.                                 based networks
  12.                        
  13.                        
  14.                        
  15.                                  DOS/Windows
  16.                        
  17.                        
  18.                        
  19.                        
  20.                        
  21.                       (C) 1994,1995 Pflug Datentechnik.
  22.                        
  23.  
  24.  
  25. Hardware and software requirements for
  26. installation:
  27.  
  28. -   network, preferably Personal NetWare,
  29.     Novell NetWare lite, NetWare >=3.11 or
  30.     Netbios network (Lantastic)
  31. -   minimum DOS 3.3
  32. -   Windows 3.1 if available
  33. -   1 serial interface per modem server, if
  34.     possible FIFO buffered (UART 16550)
  35. -   Processor depending on number of modem
  36.     servers on one computer, minimum AT
  37.     (80286)
  38.  
  39.  
  40. 1 The Concept
  41. 1.1 What is a modem-/ISDN-server?
  42. 1.2 Server-Client Operation
  43. 2 Installation
  44. 2.1 fast installation
  45. 2.2 Complete Installation
  46.  2.2.1 The Queuemanager
  47.  2.2.2 The modem server
  48.  2.2.3 The Client
  49.  2.2.4 Windows-Modemsharing
  50.  2.2.5 The ISDN server
  51.  2.2.6 The ISDN-client
  52. 3 Select Specific Modemservers By Different Ports
  53. 4 the Cooperative Mode
  54. 5 Queue Management
  55. 6 The Monitor
  56. 7 Programs Using INT 14 (BIOS)
  57. 8 Stomper And Windows For Workgroups / Windows 95
  58. 8.1 Microsoft Network
  59. 8.2 Novell Network
  60. 9 Installation On A Netware Fileserver (NLM-Version)
  61. 10 Applying Access Rights
  62. Appendix A Suitable Programs
  63. Appendix B NETINFO.EXE
  64. Appendix C Tips
  65.  1. Telemate
  66.  2. Terminate
  67.  3. Telix For Windows
  68.  4. pcAnywhere
  69. Appendix D Troubleshooting
  70. Appendix E What is a FOSSIL driver?
  71. Appendix F What is a network fossil driver?
  72. Appendix G How to order
  73. Appendix H Support
  74.  
  75.  
  76.  
  77.  
  78. 1   The Concept
  79. ~~~~~~~~~~~~~~~
  80.  
  81. 1.1 What is a modem-/ISDN-server?
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. The modemserver is a small program, that accesses the device directly, that
  85. should be made available throughout the network.
  86. There may be more than one modemserver (or ISDN-server) on one computer
  87. oder there may be several servers spread over the whole network.
  88. When a client accesses a modemserver, all communication between
  89. communication software (terminal, fax, ...) and the modem is directed
  90. through the network.
  91. Stomper is responsible for repacking the data suitable for the network, to
  92. send it and to convert it back. It appears to the user as if the modem was
  93. attached directly to his local workstation.
  94. Often the modemserver is compared to a printerserver. This is not quite
  95. correct. The main difference is, that the printer server is "batch-driven".
  96. This means, that a print job is placed into a temporary file, which is
  97. read by the printer server whenever it is ready and the contents then are
  98. sent to the printer.
  99. A modemserver works online. All data is sent to the device immediately.
  100. Additionally all line-control information is passed on.
  101.  
  102.  
  103.  
  104.  
  105. 1.2 Server-Client Operation
  106. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  107.  
  108. As soon as a client requests an available modem or an ISDN-adapter (this
  109. happens automatically, when your communications software is started),
  110. the client-program (NETFOS, NFCAPI, ...) searches for a modemserver and
  111. initiates a session.
  112. From this moment on, the server is not available for other stations. It is
  113. reserved for this one client.
  114. At the end of the session, the server will get released.
  115.  
  116.  
  117.  
  118. 2   Installation
  119. ~~~~~~~~~~~~~~~~
  120.  
  121. 2.1 fast installation
  122. ~~~~~~~~~~~~~~~~~~~~~
  123.  
  124.  
  125. First of all, the queue manager
  126.  
  127.     STMGR
  128.  
  129. is loaded on any available workstation in the network. This could be a
  130. computer not integrated in the modem sharing, or a modem server.
  131. If you intend to run Stomper in a Novell Netware 3.11 or higher network, we
  132. strongly recommend to install STMGR.NLM on the fileserver rather than
  133. installing the queuemanager on a DOS station. Refer to chapter Installation
  134. on a NetWare fileserver (NLM-version) on page 28.
  135. Please read chapter 4, waiting queue administration, in this context.
  136.  
  137.  
  138. 1.  Modemsharing
  139. ~~~~~~~~~~~~~~~~
  140.  
  141.      To install a modemserver, load
  142.  
  143.           STOMPER /Px    (x = number of the port ; 1 = COM1)
  144.  
  145.      To install a modem client, load:
  146.  
  147.           NETFOS /Px     (x = number of the port)
  148.  
  149.           NETFOS now serves all applications, that use a FOSSIL
  150.           driver. For BIOS-INT14 or Windows-COMM.DRV,
  151.           read the next chapter.
  152.  
  153. 2. ISDN-Sharing
  154. ~~~~~~~~~~~~~~~
  155.  
  156. To install an ISDN-server, load:
  157.  
  158.     STISDN
  159.  
  160. To install an ISDN-client, load:
  161.  
  162.     NFCAPI
  163.  
  164. Now your ISDN-applications can access NFCAPI(CAPI v1.1)
  165.  
  166.  
  167.  
  168. 2.2 Complete Installation
  169. ~~~~~~~~~~~~~~~~~~~~~~~~~
  170.  
  171. Stomper either works with the IPX- or the Netbios protocol. In Novell
  172. networks IPX is loaded already, so nothing else has to be done.
  173. Others (for example Lantastic: AILANBIO), however, require the installation
  174. of the Netbios driver. Most network types (NetWare/NetWare Lite,
  175. Lantastic...) supply Netbios. With the use of Netbios Stomper becomes
  176. independent of the available network.
  177.  
  178.  
  179.  
  180. 2.2.1    The Queuemanager
  181. ~~~~~~~~~~~~~~~~~~~~~~~~~
  182.  
  183. The Queuemanager performs the following tasks:
  184.  
  185. 1.  "Tracker", observes the status of all modem servers installed in the
  186.     network, containing the following information: Status of the modem
  187.     server (busy/free), the Client (Netfos) which is presently served,
  188.     number of bytes transmitted in a session.
  189.     This information is analysed and displayed for example by STMON, the
  190.     monitor program.
  191.  
  192. 2.  "Queue manager", allocates free modem servers to the clients. In order
  193.     to avoid chaos, the queue manager can only exist once in the network.
  194.     When STMGR is loaded for a second time in the network, only the tracker
  195.     part will be loaded automatically.
  196.  
  197. 3.  IPX routing. The transmitter must always know the destination network in
  198.     order to transport IPX packets over several network segments. STMGR
  199.     therefore gives his address to all routers in the network (the file
  200.     server can also work as a router and therefore adds this address to its
  201.     bindary). Stomper identifies this address by ordering it form the nearest
  202.     router. When the queue manager allocates a modem server to a client, the
  203.     network address of stomper is supplied to the client.
  204.  
  205. 4.  Logging. If the option /L is specified, a log file will be generated,
  206.     that logs all actions.
  207.  
  208. 5.  Stationrestrictions (only STMGR.NLM) See Chapter Applying access rights.
  209.  
  210.  
  211.  
  212. Command line parameters
  213.  
  214. If you intend to run Stomper in a Novell Netware 3.11 or higher network, we
  215. strongly recommend to install STMGR.NLM on the fileserver rather than
  216. installing the queuemanager on a DOS station. Refer to chapter Installation
  217. on a NetWare fileserver (NLM-version) on page 28.
  218.  
  219.  
  220.     STMGR [/F] [/U] [/L.....] [/A]
  221.  
  222.     /U   is given to remove an installed STMGR from the memory
  223.  
  224.     /F   the queue manager uses netbios, even if IPX is loaded
  225.  
  226.     /L  generates a logfile.
  227.         examples:
  228.  
  229.         STMGR /LSTOMPER.LOG       generates STOMPER.LOG in the directory, in
  230.                                   which STMGR.COM resides.
  231.  
  232.         STMGR /LC:\TEMP\ST.LOG    generates C:\TEMP\ST.LOG
  233.  
  234.     /A  Allow "autoattach". See also: NETFOS /A
  235.  
  236. please note, that if you wish to create a logfile in a desired directory,
  237. you must specify a complete path!
  238.  
  239.  
  240.  
  241. 2.2.2    The modem server
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~
  243.  
  244. The modemserver accesses the modem (or another device connected to the
  245. RS-232-port).
  246. Apart from the application data, the line-condition will be updated whenever
  247. necessary. This condition includes DCD (Data Carrier Detect), DTR (Data
  248. Terminal Ready), RI (Ring Indicator), DSR (Data Set Ready), RTS (Ready To
  249. Send) and CTS (Clear To Send).
  250.  
  251. For DOS there are 2 variants of the modemserver:
  252.  
  253. ·   STOMPER.COM              accesses the serial port directly
  254. ·   STOMPERF.COM             uses a FOSSIL driver to communicate with the
  255.                              hardware
  256.  
  257. Using the latter, makes it possible to share any communications-hardware in
  258. the network, as long as there is an apropriate FOSSIL driver available
  259. (like CFOS for ISDN).
  260.  
  261.  
  262. For information on how to install a modemserver on a NetWare fileserver,
  263. refer to chapter Installation on a NetWare fileserver (NLM-version)
  264.  
  265.  
  266. Command line parameters
  267.  
  268.  
  269. STOMPER [/Px] [/Na] [/Lxxxxxx] [/U] [/F] [/Qxx] [/Bxxxx] [/Caaa...] [/R]
  270.  
  271. The parameters are optional:
  272.  
  273.     /P   selects the COM port for the modem,
  274.          for example /P2 for COM2. If omitted,
  275.          COM1 is selected automatically.
  276.  
  277.     /U   is given to remove any already
  278.          installed STOMPER from the memory.
  279.          This is only possible while Stomper
  280.          is not active.
  281.  
  282.     /F   STOMPER is told to use Netbios
  283.          exclusively (even if IPX is loaded)
  284.  
  285.     /Q   for unconventional IRQs. /Q7 => IRQ7
  286.  
  287.     /B   for unconventional ports. /B3E8  =>
  288.          Port 3E8
  289.  
  290.     /C   Cooperative mode: see chapter 3,
  291.          Cooperative mode
  292.  
  293.     /L   Lock Baud. Independent of the bps
  294.          rate chosen by the application
  295.          (terminal program,...), Stomper
  296.          always selects automatically the bps
  297.          rate of this parameter, for example
  298.  
  299.          /L57600 (locked).
  300.  
  301.          Attention: Windows applications
  302.          ignore this parameter!
  303.  
  304.     /N   one single character is added to this
  305.          option (for example one letter or one
  306.          digit), giving the modem server an
  307.          individual identification. Each modem
  308.          server has to be identified
  309.          individually (several modem servers
  310.          on one computer have individual
  311.          characters).
  312.  
  313.     /R   ensures RTS/CTS data flow control.
  314.          This is very helpful, for example if
  315.          you encounter problems when sending
  316.          with Winfax. Normally this option
  317.          does not influence any other
  318.          applications.
  319.  
  320.     /Z   16550 FIFO buffer control
  321.                 /Z0 FIFO off
  322.                 /Z1 FIFO on 1 byte threshold
  323.                 /Z4 FIFO on 4 byte threshold
  324.                 /Z8 FIFO on 8 byte threshold (default)
  325.                 /Z14FIFO on 14 byte threshold
  326.  
  327. It is not recommended to use this parameter!
  328. Stomper normally selects an 8 byte threshold for the FIFO buffer, which
  329. causes the least potential errors.
  330. On very slow PCs (286 - 6 MHz), it may be necessary to use /Z1.
  331.  
  332.  
  333.  
  334. 2.2.3    The Client
  335. ~~~~~~~~~~~~~~~~~~~
  336.  
  337. The modem client provides access to a modemserver. All applications that
  338. can use a FOSSIL driver or BIOS-INT14 (option /I) can use it to access a
  339. network modem.
  340.  
  341. Command line parameters
  342.  
  343.  
  344. NETFOS [/Px] [/U] [/I] [/F] [/Naaa...] [/A|/A+]
  345.  
  346.     /P   specifies which COM port will be
  347.          redirected, for example. /P2 for
  348.          COM2. COM1 is chosen automatically
  349.          when this parameter is not used.
  350.  
  351.     /U   is given to remove an installed
  352.          NETFOS from the memory.
  353.  
  354.     /I   This parameter is necessary to
  355.          redirect programs which communicate
  356.          using the BIOS-INT-14. With this
  357.          parameter given, Netfos finds out if
  358.          an application is able to serve a
  359.          fossil interface, and reacts
  360.          accordingly.
  361.  
  362.          Without this parameter Netfos can
  363.          only serve Windows programs or
  364.          programs which support a fossil
  365.          driver.
  366.  
  367.     /F   Netfos uses Netbios (even if IPX is
  368.          loaded)
  369.  
  370.     /N   All modem servers wanted in the
  371.          network are listed here. When for
  372.          example. /N123 is given, the
  373.          queuemanager selects the first
  374.          available modem server from the list.
  375.          The priority is from left to right,
  376.          so that the queuemanager selects
  377.          STOMPER /N2 when STOMPER /N1 is
  378.          occupied.
  379.          This option is invalid (and
  380.          meaningless) In the 1-server version.
  381.  
  382.     /A   "Autoattach"-mode. When a modemserver
  383.          is assigned to a user after he was
  384.          placed in the queue (waiting for a
  385.          modemserver to become available),
  386.          this option suppresses the message
  387.          "Connected to modemserver". So the
  388.          connection will be established
  389.          without interaction. For both /A and
  390.          /A+ STMGR must have been loaded with
  391.          the option /A as well!
  392.  
  393.     /A+  Same as /A, but additionally the user
  394.          will be placed into the waitingqueue
  395.          automatically, in case there is no
  396.          modemserver available. This mode runs
  397.          completely unattended.
  398.  
  399. Note that the parameter /Px does not have to be identical for the two
  400. drivers. For Stomper /Px defines the interface which is physically connected
  401. with the modem. For Netfos /Px defines only the interface which is addressed
  402. by the terminal program.
  403.  
  404.  
  405.  
  406. 2.2.4    Windows-Modemsharing
  407. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  408.  
  409. In the file SYSTEM.INI (Windows directory) change the following line in
  410. the [boot]-section:
  411.  
  412. comm.drv=comm.drv
  413.  
  414. change into
  415.  
  416. comm.drv=stcomm.drv
  417.  
  418. Make sure that there is only one line of comm.drv=...!!
  419.  
  420. Attention!
  421. After Winfax installations comm.drv is usually changed into wfxcomm.drv.
  422. This can be replaced without problems.
  423.  
  424. STCOMM.DRV  should be placed on a DOS path or in a windows directory.
  425. Alternatively, the whole path can be given.
  426.  
  427.  
  428.  
  429. 2.2.5 The ISDN server
  430. ~~~~~~~~~~~~~~~~~~~~~
  431.  
  432. The ISDN server (STISDN) makes a CAPI accessible by the clients (NFCAPI).
  433. An STISDN can only serve one client at a time. To let more than one client
  434. access the CAPI at the same time, STISDN has to be loaded multiple times.
  435. These can use the same CAPI, depending on how many applications this CAPI
  436. can support (usually 2 to 4).
  437.  
  438. Command line parameters
  439.  
  440.  
  441. STISDN [/Na] [/U] [/F] [/M...] [/Kn]
  442.  
  443.  
  444.     /U   is given to remove any already
  445.          installed STISDN from the memory.
  446.          This is only possible while STISDN is
  447.          not active.
  448.  
  449.     /F   STISDN is told to use Netbios
  450.          exclusively (even if IPX is loaded)
  451.  
  452.     /N   one single character is added to this
  453.          option (for example one letter or one
  454.          digit), giving the modem server an
  455.          individual identification. Each ISDN
  456.          server has to be identified
  457.          individually (several ISDN servers on
  458.          one computer have individual
  459.          characters).
  460.  
  461.     /M...    defines, how much memory is
  462.              reserved for communications. The
  463.              default is 16384 Bytes. Values from
  464.              4000-65500 Bytes are accepted.
  465.              The optimum depends on the software
  466.              you will be using and the number of
  467.              concurrent ISDN-connections. The
  468.              default value usually is enough for 1
  469.              application with channel-bundeling or
  470.              two concurrent applications using
  471.              each a single ISDN-connection.
  472.  
  473.     /Kn  Tells STISDN to use ISDN-adapter number n.
  474.          If no adapter number is given, 0 is assumed
  475.          (first adapter)
  476.  
  477.  
  478. 2.2.6  The ISDN-client
  479. ~~~~~~~~~~~~~~~~~~~~~~
  480.  
  481. The ISDN cclient (NFCAPI) provides applications with a virtual CAPI v1.1-
  482. interface. Up to 4 applications can be serviced by the same NFCAPI.
  483.  
  484.  
  485. Command line parameters
  486.  
  487.  
  488. NFCAPI [/U] [/F] [/Naaa...] [/A|/A+]
  489.  
  490.     /U   is given to remove an installed
  491.          NFCAPI from the memory.
  492.  
  493.     /F   NFCAPI uses Netbios (even if IPX is
  494.          loaded)
  495.  
  496.     /N   All ISDN servers wanted in the
  497.          network are listed here. When for
  498.          example, /N123 is given, the
  499.          queuemanager selects the first
  500.          available ISDN server from the list.
  501.          The priority is from left to right,
  502.          so that the queuemanager selects
  503.          STISDN /N2 when STISDN /N1 is
  504.          occupied.
  505.          This option is invalid (and
  506.          meaningless) In the 1-server version.
  507.  
  508.     /A  "Autoattach"-mode. When a ISDN server
  509.          is assigned to a user after he was
  510.          placed in the queue (waiting for a
  511.          ISDN server to become available),
  512.          this option suppresses the message
  513.          "Connected to ISDN server". So the
  514.          connection will be established
  515.          without interaction. For both /A and
  516.          /A+ STMGR must have been loaded with
  517.          the option /A as well!
  518.  
  519.     /A+  Same as /A, but additionally the user
  520.          will be placed into the waitingqueue
  521.          automatically, in case there is no
  522.          ISDN server available. This mode runs
  523.          completely unattended.
  524.  
  525.  
  526. 3   Select specific modemservers by different ports
  527. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  528.  
  529. Example:
  530.  
  531. You have 5 modem-/ISDN-servers installed in your network:
  532.  
  533. ·   three modems with IDs 1, 2 and 3
  534. ·   two ISDN-lines with IDs 4 and 5
  535.  
  536. Of course you will want to use an ISDN-line, when you need an ISDN-line
  537. and a modem line, when you need a modem line. You can do this by simply
  538. entering the following command line:
  539.  
  540. NETFOS /P1(123) /P2(45)
  541.  
  542. When your Application addresses COM1, you will get connected to
  543. modemserver 1, 2 or 3, whichever is available. When your application uses
  544. COM2, one of th ISDN lines will be selected.
  545.  
  546. Note that there is no option /N specified, since this is completely replaced
  547. by the values in brackets. You can specify up to 4 ports.
  548.  
  549. Of course you can use this method to distinguish different modemtypes as
  550. well - ISDN was chosen as a typical example of different transport media.
  551.  
  552.  
  553.  
  554. 4   The Cooperative Mode
  555. ~~~~~~~~~~~~~~~~~~~~~~~~
  556.  
  557.  
  558. This mode - under certain circumstances - enables the use of another
  559. software (for example a mailbox) on the modem server - sharing the port
  560. cooperatively with Stomper.
  561.  
  562. Parameter: /Cxxxxx
  563.  
  564. xxxxx stands for any modem command. At the end of a session this command is
  565. sent to the modem in order to re-initialize it. CR/LF is added to this
  566. string (for example. ATZ), automatically.
  567.  
  568. Thus the modem server can run a mailbox, which will be stopped automatically
  569. when a client in the network demands the modem. While a caller is logged
  570. into the mailbox, Stomper is inactive.
  571.  
  572. In order to avoid fatal failures on the computer, please read the following
  573. lines even if this sounds a bit technical:
  574.  
  575. For safety reasons a network-modem demand is rejected, when the CD signal
  576. is active, for example, when someone is logged into the mailbox. Stomper
  577. will also be blocked for another 60 seconds after the last ring.
  578. This mode has to be handled with care, as it is quite rude to block an
  579. application just like that, but this can be done for example with FrontDoor
  580. and Remote Access.
  581.  
  582. As during the blocking of the modem the bps-rate could be changed, at the
  583. end of such a session Stomper sends an optional command (see above, "/Caaa")
  584. to the modem in order to set the correct bps rate. For this, the modem must
  585. have an automatic baudrate identification.
  586.  
  587. In the cooperative mode Stomper MUST NOT BE LOADED in the high memory
  588. area(UMB), due to the following:
  589.  
  590. The computer will be stopped at an appropriate time, that is in the moment
  591. of a timer interrupt (produced by the computer 18 times per second).
  592.  
  593. "Appropriate" means:
  594.  
  595. 1.  there is no hard disk or disk access
  596. 2.  Windows is inactive
  597. 3.  The program interrupted is placed in the memory above stomper and
  598.     under the high memory area from A000:0000 on.
  599.  
  600. No. 3 ensures that no IPX routine has been interrupted.
  601. As Stomper depends on IPX, it would not dare to touch this without being
  602. affected personally. As Stomper needs the IPX (or Netbios) drivers, they
  603. are normally placed in a lower memory section or in an UMB. But if Stomper
  604. has also been loaded in the high memory area, there is no certainty where
  605. the network drivers are placed related to Stomper.
  606.  
  607. It is possible that the interrupt does not appear. This happens for example.
  608. when the command line in DOS is used, which is mainly executed in
  609. COMMAND.COM (below Stomper) or in BIOS (>A000). The use of the interface is
  610. not affected in this case.
  611.  
  612.  
  613.  
  614.  
  615.  
  616. 5   Queue Management
  617. ~~~~~~~~~~~~~~~~~~~~
  618.  
  619.  
  620. In order to enable a precise access to one or several modem servers in the
  621. network, the program
  622.  
  623. STMGR.COM
  624.  
  625. has to be loaded on one computer (any) in the network. STMGR.COM should
  626. already be active in the network, before a Client (Netfos) or modem server
  627. (Stomper) is loaded. Preferably this program should be installed on a
  628. modem server. If you are working with Novell Netware, the best choice will
  629. be the Fileserver (STMGR.NLM)
  630.  
  631. This program operates completely in the background and does not require
  632. much memory.
  633.  
  634.  
  635. The queue manager's strategies
  636.  
  637. When a client demands a modem server, the queue manager tries to allocate
  638. a free modem server which is selected by NETFOS /Naaa...(from left to right).
  639. In case all modem servers are busy, the client computer receives the
  640. following message:
  641.  
  642. No modemserver available. Queue in?       Y/N
  643.  
  644. After confirming Y, the following message appears:
  645.  
  646. Queued in. Wait in foreground?         Y/N
  647.  
  648. Now there are two possibilities:
  649.  
  650. 1.  "Wait in the background" (N) tells the application that no fossil
  651.     driver is installed (not recommended for pure BIOS INT14 applications).
  652.     The computer can be used and as soon as a modem server is free, the
  653.     following message appears:
  654.  
  655.     Connected to modem server    (ENTER)
  656.  
  657. The queue manager marks the modem server as "reserved". The user has
  658. 1,5 minutes to start his application and to use the modem server.
  659.  
  660.  
  661. 2.  While waiting in the foreground, the following message appears
  662.  
  663.     Waiting for modem server...    (ESC)
  664.  
  665.     In the meantime the computer cannot be used for other applications.
  666.  
  667. Under windows this process is executed accordingly, but only the
  668. application in use is paused.
  669.  
  670.  
  671.  
  672.  
  673.  
  674. 6   The Monitor
  675. ~~~~~~~~~~~~~~~
  676.  
  677. The monitor (STMON.EXE) provides an overview over the modem servers
  678. installed in the network and the proceedings can be observed. The monitor is
  679. started by loading
  680.  
  681. STMON
  682.  
  683. As STMON displays the information obtained from the tracker, it depends on
  684. STMGR.COM being loaded. If STMGR is not already in memory, the monitor will
  685. load it automatically. For this, however, STMGR.COM must be either
  686.  
  687.     -   in the same directory as STMON.EXE or
  688.     -   in the DOS path.
  689.  
  690. Attention: The monitor must not be started in a DOS box under windows!
  691.  
  692. The monitor displays ten sections on the screen, each containing information
  693. of an individual modem server.
  694.  
  695. Field identifications:
  696.  
  697. -   Network address - individual address in the network which is preset by
  698.     the network adaptor. In order to obtain a better overview, a file called
  699.  
  700.     NODES.LST
  701.  
  702.     can be created, in which names are allocated to the network addresses.
  703.     An example for such a file:
  704.  
  705.     924e32a  John's abacus
  706.     80ca23e5 venus
  707.  
  708.     ... allocating the names "John's abacus" and "venus" to the according
  709.     network addresses. John's abacus and venus will replace the cryptic
  710.     address names on the monitor.
  711.  
  712. -   Served interface - the serial interface served by the modem server
  713.     or CAPI
  714.  
  715. -   Status - status of the modem server.
  716.     Possible states:
  717.  
  718.     - free           the modem server is available at the moment
  719.     - Ser. <Client>  the modem server is just serving the client named
  720.                      <Client>
  721.     - Res. <Client>  the modem server is presently reserved for the client
  722.                      <Client>.
  723.     - locally in use The modem server is presently used locally in the /"C"
  724.                      mode         (for example a user in the mailbox)
  725.  
  726. -   Sent / received bytes - number of bytes transmitted in the current
  727.     session. This information will be held until the start of a new session.
  728.  
  729. -   Identification - the identification of the modem server (/Na).
  730.  
  731.  
  732.  
  733.  
  734. 7   Programs Using INT 14 (BIOS)
  735. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  736.  
  737.  
  738. The fossil driver is to be understood as an extension to the BIOS-INT 14
  739. interrupt. However, Stomper expects that the software used initializes the
  740. fossil driver (not necessary with BIOS routines).
  741. For programs only using BIOS-INT 14, NETFOS has to be loaded with the
  742. parameter /I.
  743. With pure INT 14 applications, Stomper always switches to RTS/CTS data flow
  744. control.
  745.  
  746. Approximately 20 seconds after the end of an "INT-14 program" the modem
  747. server becomes available for others again.
  748.  
  749. When using fax software, which communicates via INT 14, it is absolutely
  750. necessary to lock Stomper on an appropriate rate. The ideal bps rate depends
  751. on the modem used.
  752. Standard modems transmit faxes with a rate of up to 14400 bps, or 19200 bps
  753. on the phone line. In this case the bps rate has to be locked on 19200 bps.
  754. Most modems accept a higher rate, for example 57600 bps, when transmitting
  755. faxes.
  756.  
  757. For modems with a maximum baud rate of 9600 bps, Stomper should be locked
  758. on 9600 bps (see parameter /L on page 6).
  759.  
  760.  
  761.  
  762. 8   Stomper and Windows for Workgroups / Windows 95
  763. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  764.  
  765. A "real" Windows 95 version should be available december 95
  766.  
  767.  
  768.  
  769. WfW and Windows 95 normally load their own network drivers. This means, in
  770. these cases, there are no network protocols available prior to loading
  771. Windows.
  772. In case you are running Netware or any network with DOS-drivers, you can
  773. skip this chapter.
  774.  
  775. Create the file WINSTART.BAT in your Windows-directory, like
  776.  
  777. -----------------------------------
  778. NETFOS /P1
  779. -----------------------------------
  780.  
  781. The batchfile WINSTART.BAT will be executed by Windows after all
  782. system-drivers have been loaded (including network drivers).
  783.  
  784. STCOMM.DRV should be loaded as described in chapter "Complete Installation"
  785.  
  786. Be aware that this version of Stomper only supports 16-bit applications!
  787. New 32-bit software uses a different driver.
  788.  
  789.  
  790. 8.1 Microsoft Network
  791. ~~~~~~~~~~~~~~~~~~~~~
  792.  
  793. Make the following changes to your Windows network setup:
  794.  
  795. Defaultprotocol:   NetBEUI
  796.  
  797. NCBS=255
  798.  
  799. NetHeapSize=20
  800.  
  801.  
  802. 8.2 Novell Network
  803. ~~~~~~~~~~~~~~~~~~
  804.  
  805. Make the following changes to your Windows network setup:
  806.  
  807. Defaultprotocol:   IPX/SPX
  808.  
  809. SPX Connections = 60
  810.  
  811.  
  812.  
  813. 9   Installation on a NetWare fileserver (NLM-version)
  814. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  815.  
  816.  
  817. Copy STMGR.NLM and STOMPER.NLM to the SYS:SYSTEM directory.
  818.  
  819. To install STMGR.NLM on the fileserver, enter
  820.  
  821. load STMGR
  822.  
  823. at the console.
  824.  
  825. To install a modemserver, you will need to install an asynchonous
  826. I/O-driver first. This requires the module AIO.NLM and any AIO-driver.
  827. The appropriate AIO-driver for standard RS232 is AIOCOMX.NLM. You can
  828. download AIO-drivers from Compuserve NOVLIB or from our BBS. Several
  829. AIO drivers for Hostess, Digiboard, etc. are available.
  830.  
  831. For available commandline options recognized by STOMPER.NLM and STMGR.NLM,
  832. refer to chapter Complete Installation on page 6.
  833.  
  834. Note the different format of STOMPER-option /P for port selection:
  835.  
  836. /P<hardwaretype>,<boardnumber>,<portnumber>
  837.  
  838. The three values are shown when you load the AIO-driver. If you are not
  839. sure what to type, you can load STOMPER.NLM without the /P-option.
  840. Stomper will let you select the desired port and then display the
  841. appropriate commandline you should use in future.
  842.  
  843. If you posess a multi-modemserver version of Stomper, you can load
  844. STOMPER.NLM multiple times.
  845.  
  846. If you type
  847.  
  848. unload stomper
  849.  
  850. at the system console, you will disable all running modemservers.
  851.  
  852. Caution!!
  853.  
  854. -   There is a bug in the Netware 3.x / 4.0x (not 4.1) -
  855.     SPX-protocol. This bug known to STOMPER.NLM and
  856.     Stomper tries hard to avoid problems that might
  857.     arise.
  858.     But wo do strongly advise you to install the
  859.     following Novell-patches:
  860.  
  861.     PATCHMAN.NLM
  862.     SPXDDFIX.NLM
  863.     SPXFIX2.NLM
  864.  
  865.     These three modules are contained in the
  866.     archive STRTL3.EXE, that can be downloaded free
  867.     from Compuserve NOVLIB or from our support BBS.
  868.  
  869. -   If you have problems loading AIO.NLM,
  870.     STOMPER.NLM and STMGR.NLM, and you get a
  871.     message like
  872.  
  873.     "Public symbol IsColorMonitor not found",
  874.  
  875.     then you have an old version of CLIB.NLM
  876.     (Netware 3.11). Just install an updated
  877.     version, that is part of the archive
  878.     LIBUP4.EXE (Compuserve NOVLIB or our support
  879.     BBS)
  880.  
  881. -   When loading AIOCOMX, do not use the
  882.     option "node=..." if possible
  883.  
  884. -   You should use AIOCOMX >= 2.11. It should
  885.     be loaded with the maxrate-option:
  886.  
  887.     load aiocomx [...] maxrate=115200
  888.  
  889. -   The use of a FIFO (16550)-serial UART is
  890.     strongly recommended.
  891.  
  892.  
  893.  
  894. 10  Applying access rights
  895. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  896.  
  897. STMGR.NLM provides a mechanism to refuse access to all or specific
  898. modemservers by username, stationaddress and/or network.
  899.  
  900. This mechanism is activated, as soon as STMGR.NLM finds a file named
  901. QMREST.LST in the same directory, STMGR.NLM is contained in. If this file
  902. is not present, no restrictions apply.
  903.  
  904. This file could look like this:
  905.  
  906.  
  907.              [stations]
  908.              928485
  909.              80A23E42     12Q
  910.  
  911.              [nets]
  912.              1000002
  913.              1000003       1
  914.  
  915.              [names]
  916.              supervisor
  917.              Peter         24
  918.  
  919.  
  920. Rules:
  921.  
  922. -   there are 3 possible sections: [stations], [nets] and [names]
  923. -   you can omit particular sections. There will be no restrictions for
  924.     these sections.
  925. -   if a section is present, it defines  objects (stationaddresses,
  926.     usernames or networkaddresses), that have access to modemservers. All
  927.     objects of this sectiontype, that are not defined, will not have access
  928.     to any modemserver.
  929. -   if only the object is entered in a line, it receives access rights to
  930.     all modemservers throughout the network. If you additionally enter a
  931.     list of modemserver-ids - separated by spaces or tabs from the objects
  932.     designation - the object will only have access to the specified
  933.     modemservers.
  934. -   access rights are combined by logical and, which means, the user must
  935.     qualify by station, network and username (in case restrictions apply
  936.     respectively)
  937.  
  938. Typically the file QMREST.LST will only contain
  939. a [names] or [nets] section.
  940.  
  941.  
  942.  
  943. Appendix A    Suitable Programs
  944. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  945.  
  946.  
  947. All windows programs, using the functions (API) (provided by windows
  948. COMM.DRV) for the interface addressing, are supported.
  949.  
  950. DOS:
  951.  
  952. Not every terminal program supports a fossil driver. An example for a
  953. program with FOSSIL support is Telemate (In Options / Terminal, FOSSIL can
  954. be selected)
  955.  
  956. For the use of Telemate note the following: in order to work with the dial
  957. list, for each listing the fossil driver has to be selected individually.
  958. To select the fossil support in Telemate, first the baud rate has to be
  959. set to a maximum of 38400bps. Otherwise fossil will be ignored!
  960.  
  961. A short list of programs which have been tested with Stomper:
  962.  
  963. Name            Operating       Comments
  964.                 system
  965. ------------------------------------------------------------------
  966. Telemate        DOS             extensive and comfortable
  967.  
  968. FX-Term         DOS             Very easy to handle GUI, works with
  969.                                 RoboBoard.
  970.  
  971. Terminate       DOS             extensive (similar to Telemate). IEMSI
  972.                                 support
  973.  
  974. Dos/CIS         DOS             Compuserve information manager
  975.  
  976. Terminal        Windows         Terminal program included in windows packet
  977.  
  978. GoCIS           Windows         Offline Compuserve navigator
  979.  
  980. NavCIS          Windows         Offline Compuserve navigator
  981.  
  982. WinCIS          Windows         Compuserve information manager
  983.  
  984. PowerCom        Windows         terminal program
  985.  
  986. Telix for       Windows         extensive and comfortable terminal program
  987. Windows
  988.  
  989. Transend        DOS/Windows     terminal / fax
  990.  
  991. RemoteAccess    DOS             BBS software
  992.  
  993. Frontdoor       DOS             Fido mailer
  994.  
  995. Binkley         DOS             Fido mailer
  996.  
  997. Crosspoint      DOS             Fido / Z net / UUCP - point system
  998.  
  999. Winfax          Windows         fax software
  1000.  
  1001. Bitfax          Windows         fax software
  1002.  
  1003. Unicom          Windows         comfortable terminal program
  1004.  
  1005.  
  1006.  
  1007. Most of these programs are available are available as shareware on our
  1008. Support BBS (see end of Document).
  1009.  
  1010.  
  1011.  
  1012.  
  1013. Appendix B    NETINFO.EXE
  1014. ~~~~~~~~~~~~~~~~~~~~~~~~~
  1015.  
  1016. This a small diagnostic tool added to the packet, giving some information of
  1017. the network environment (received from netbios), for example
  1018.  
  1019.  
  1020. Permanent name:                         0000C0039A79   ; network address
  1021. Jumper:                                 40
  1022. POST result:                            00 
  1023. Version:                                0.1
  1024. Minutes up:                             0
  1025. Number of CRC errors:                   0
  1026. Number of alignment errors:             0
  1027. Number of collisions:                   0
  1028. Number of aborts:                       1
  1029. Number of transmitted packets:          6
  1030. Number of received packets:             10
  1031. Number of retransmits:                  4
  1032. Number of out-of-buffer-counts:         0
  1033. Free NCBs:                              10
  1034. Max. NCBs:                              12
  1035. Active sessions:                        32
  1036. Max. packet size:                       1024
  1037. Names:                                  1
  1038. NFOSMPX1                                0
  1039.  
  1040.  
  1041. Attention! This tool can only be useful when Netbios is actually installed.
  1042. Otherwise no useful information will be displayed here! This information
  1043. is of no use for IPX.
  1044.  
  1045.  
  1046. Appendix C    Tips
  1047. ~~~~~~~~~~~~~~~~~~
  1048.  
  1049.  
  1050. 1.  Telemate
  1051. ~~~~~~~~~~~~
  1052.  
  1053. Before you select FOSSIL, be careful to set the speed to not more than
  1054. 38400 bps. Otherwise Telemate will reject the FOSSIL-Setting (without
  1055. displaying a message).
  1056. In case even this fails, the safest way is to edit TM.CFG manually. Just
  1057. change
  1058.  
  1059. Connection=Modem
  1060.  
  1061. to
  1062.  
  1063. Connection=Fossil
  1064.  
  1065. and make sure that the entry Port= is correct.
  1066.  
  1067. Also, FOSSIL has to be selected for every entry in the Dial-List.
  1068.  
  1069.  
  1070. 2.  Terminate
  1071. ~~~~~~~~~~~~~
  1072. Early versions of Terminate (<3.x) had a problem identifying a FOSSIL 
  1073. driver that does not support all serial ports at once, like does NETFOS. 
  1074. If you have Terminate 3.x or higher, you don't have to read on.
  1075. The first time Terminate is set up for FOSSIL, it expects that a FOSSIL
  1076. driver is installed on COM1. This, of course, is not always given (e.g.
  1077. NETFOS installed on COM2).
  1078. It may result in a system-crash.
  1079.  
  1080. Workaround:
  1081.  
  1082. either use NETFOS on COM1 or
  1083.  
  1084. the first time, you switch Terminate to FOSSIL, do it with a regular FOSSIL
  1085. driver (like BNU or X00) installed. From then on you can use NETFOS.
  1086.  
  1087. If you don't have a FOSSIL driver handy, load
  1088.  
  1089. NETFOS /P1() /P2()
  1090.  
  1091. This installs NETFOS on both COM1 and COM2.
  1092.  
  1093.  
  1094. 3.  Telix For Windows
  1095. ~~~~~~~~~~~~~~~~~~~~~
  1096.  
  1097. Use the COM-Setting, not FOSSIL! In Windows it is always recommended to use
  1098. STCOMM whenever possible.
  1099. Apart from that, the FOSSIL support of early versions of TfW is buggy.
  1100.  
  1101.  
  1102. 4.  pcAnywhere
  1103. ~~~~~~~~~~~~~~
  1104.  
  1105. Use the plain INT14-Setting and do not set higher speeds than 9600 bps.
  1106. Otherwise pcAnywhere will not be able to initialize the port.
  1107. To achieve higher speeds, refer to the modemserver switch /L.
  1108.  
  1109. Appendix D    Troubleshooting
  1110. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1111.  
  1112. Problem              possible source             solution / remarks
  1113.  
  1114. The terminalprogram  The terminalprogram might   If provided by the terminal
  1115. doesn't react - no   address the hardware        software, switch to Fossil
  1116. characters are       directly                    or INT 14.
  1117. transmitted                                      In case the software doesn't
  1118.                                                  support a software inter-
  1119.                                                  face,
  1120.                                                  there is no way of
  1121.                                                  redirecting port usage.
  1122.  
  1123.                      The terminalprogram is set  Call NETFOS /I when using
  1124.                      to INT-14, but Netfos       BIOS-INT14-routines.
  1125.                      wasn't loaded with the /I-
  1126.                      option.
  1127.  
  1128.                      the wrong port is being     set the com-port settings of
  1129.                      addressed.                  the terminal software to the
  1130.                                                  value specified in the
  1131.                                                  commandline of Netfos.
  1132.  
  1133. Characters are lost  A non-buffered serial       Use a buffered serial device
  1134. during transmission  hardware is used            (UART 16550). Such can
  1135.                                                  be obtained for a small fee
  1136.                                                  in most computer stores.
  1137.                                                  Stomper relies on buffered
  1138.                                                  communications devices
  1139.                                                  more than other COM-
  1140.                                                  software, since it has to
  1141.                                                  deal with many interrupt
  1142.                                                  types at once (timer,
  1143.                                                  network and serial).
  1144.  
  1145.                      no handshaking active       Usually you have to specify
  1146.                                                  the type of handshaking you
  1147.                                                  want to use in the setup of
  1148.                                                  your communications
  1149.                                                  software. In most cases it's
  1150.                                                  best to set hardware
  1151.                                                  handshaking (RTS/CTS) to
  1152.                                                  on and software
  1153.                                                  handshaking (XON/XOFF) to
  1154.                                                  off.
  1155.  
  1156. Stomper hangs in     Stomper was loaded in       Stomper cannot be loaded in
  1157. cooperative mode     high memory                 high memory when driven in
  1158.                                                  cooperative mode.
  1159.  
  1160. It works with DOS    STCOMM.DRV wasn't           Make sure, the line
  1161. but not with Windows installed or wasn't         comm.drv=stcomm.drv is
  1162.                      installed correctly         placed in the [boot]-section
  1163.                                                  of you SYSTEM.INI-file and
  1164.                                                  that there is only one
  1165.                                                  occurence of a line
  1166.                                                  beginning with "comm.drv="
  1167.  
  1168. Fax-sending causes   You are using a DOS-Fax-    In this case, Stomper sets
  1169. problems             software that uses the      the handshake-method to
  1170.                      Bios-INT 14 interface.      "Hardware". Fax
  1171.                                                  transmission with class 2
  1172.                                                  expects software flow
  1173.                                                  control. make sure that your
  1174.                                                  modem is set to hardware
  1175.                                                  flowcontrol explicitly
  1176.  
  1177.  
  1178.                      XON/XOFF handshaking        start Stomper with the
  1179.                      doesn't function properly   commandline option /R
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185. Appendix E    What is a FOSSIL driver?
  1186. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1187.  
  1188. There are various possibilities for a DOS program to address serial
  1189. interfaces of a PC:
  1190.  
  1191. There is the hardware related method, communicating directly with the
  1192. interface components. This method is used very often because it's quick and
  1193. uncomplicated for the program user - no unnecessary thoughts about a
  1194. fossil driver and its implementation.
  1195.  
  1196. "Polite" programs use the 4 functions provided by the computer BIOS (INT 14):
  1197. Baud rate setting, character transmission, character receive and fetching
  1198. the interface status. This method has the advantage of being hardware
  1199. independent (only BIOS has to have the information how to communicate with
  1200. the hardware - the programmer isn't troubled with that). Big and decisive
  1201. disadvantage: under DOS, BIOS allows max. 9600 bps, which is out of date
  1202. today. Furthermore BIOS routines are generally quite slow.
  1203.  
  1204. Another possibility is the fossil driver, combining the advantages of the
  1205. solutions mentioned above - speed and hardware independence - troubling the
  1206. user with only one installation.
  1207.  
  1208. The fossil driver offers buffered interface communication as an additional
  1209. function to the BIOS, emulating the interface functions of BIOS. Data
  1210. arriving at the interface needn't be handled immediately by the software,
  1211. but are stored in a ring buffer. A program using BIOS for example, has to
  1212. handle every single character before the next arrives in order to avoid a
  1213. loss of data. With a fossil driver the data can be fetched and handled in
  1214. blocks.
  1215.  
  1216.  
  1217. Appendix F    What is a network fossil driver?
  1218. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1219.  
  1220.  
  1221. It's easy to exploit the advantage of a hardware independent program with
  1222. the use of a fossil driver. A suitable driver can pretend any digital
  1223. communication element against such a hardware independent program, for
  1224. example as COM2. The programm doesn't care how this works, as long as the
  1225. driver handles the mass of data.
  1226.  
  1227. Stomper uses this circumstance. A modem server is installed on a network
  1228. integrated computer linked to a modem. The modem server waits for a network
  1229. fossil driver connection, which again bluffs to be communicating with a
  1230. serial interface. At the same time a lot of instruction data and other data
  1231. are passed over the network, but don't worry, a normal network is hardly
  1232. concerned with that.
  1233.  
  1234.  
  1235. Appendix G - How to order
  1236. ~~~~~~~~~~~~~~~~~~~~~~~~~
  1237.  
  1238. We have registration sites in many countries. Run the program
  1239.  
  1240. ORDER.EXE
  1241.  
  1242. to get information on pricing and registration sites. You will be prompted
  1243. to select your country.
  1244.  
  1245.  
  1246.  
  1247. Appendix H    Support
  1248. ~~~~~~~~~~~~~~~~~~~~~
  1249.  
  1250. You can determine your local support site by running ORDER.EXE.
  1251. Pflug Datentechnik can be contacted via
  1252.  
  1253.  
  1254. Fax          49 / 7156 - 939005
  1255. e-mail       100340.1047@compuserve.com
  1256. Compuserve   Pflug 100340,1047
  1257. Fido         2:246/1009 (per Crashmail only, please!)
  1258.  
  1259. Mailbox  (see below)
  1260.  
  1261. Current Stomper versions and several shareware/PD software can be
  1262. downloaded from our mailbox:
  1263.  
  1264. +49 / 7156 - 939006
  1265.  
  1266.  
  1267. Internet FTP sites:
  1268.  
  1269. ftp.u-net.com                   /com/acl/stomper
  1270. cyberstation.net                /pub/silvrado/stomper
  1271. ftp.dyson.brisnet.org.au        /pub/clarion/stomper
  1272.  
  1273. WWW:
  1274. ftp://www.acl.co.uk/com/acl/stomper
  1275. http://dyson.brisnet.org.au/~cugq/stomper.html
  1276.  
  1277. Compuserve:
  1278.  
  1279. GO PCCOM oder GO PCPRO
  1280.  
  1281.